---
title: OpenWeatherMap
---

>[OpenWeatherMap](https://openweathermap.org/api/) provides all essential weather data for a specific location:
>- Current weather
>- Minute forecast for 1 hour
>- Hourly forecast for 48 hours
>- Daily forecast for 8 days
>- National weather alerts
>- Historical weather data for 40+ years back

This page covers how to use the `OpenWeatherMap API` within LangChain.

## Installation and Setup

- Install requirements with:

<CodeGroup>
```bash pip
pip install pyowm
```

```bash uv
uv add pyowm
```
</CodeGroup>

- Go to OpenWeatherMap and sign up for an account to get your API key [here](https://openweathermap.org/api/)
- Set your API key as `OPENWEATHERMAP_API_KEY` environment variable

## Wrappers

### Utility

There exists a OpenWeatherMapAPIWrapper utility which wraps this API. To import this utility:

```python
from langchain_community.utilities.openweathermap import OpenWeatherMapAPIWrapper
```

For a more detailed walkthrough of this wrapper, see [this notebook](/oss/integrations/tools/openweathermap).

### Tool

You can also easily load this wrapper as a Tool (to use with an Agent).
You can do this with:

```python
import os
from langchain_community.utilities import OpenWeatherMapAPIWrapper

os.environ["OPENWEATHERMAP_API_KEY"] = ""
weather = OpenWeatherMapAPIWrapper()
tools = [weather.run]
```

For more information on tools, see [this page](/oss/how-to/tools_builtin).
